home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1994 September / PSL Monthly Shareware CD-ROM (September 1994).ISO / dos / communic / vote291.exe / VOTE.DOC < prev    next >
Text File  |  1994-06-01  |  11KB  |  220 lines
  1.        ▄▄▄ ▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄
  2.        █ █ █ █ █ ▄▄▄ █ █▄▄ ▄▄█ █ ▄▄▄▄█ █ ▄▄▄ █  ▄█▀█▄ ▄█▀█▄
  3.        █▄▀█▀▄█ █ █▄█ █   █ █   █ ▄▄▄█▄ █ ▄▄ ▄█  █▄ ▄█ █▄ ▄█
  4. v2.91   ▀█▄█▀  █▄▄▄▄▄█   █▄█   █▄▄▄▄▄█ █▄██▄▄█   ▀▀▀   ▀▀▀   (C)94 Bill Marcy
  5.  
  6. -----------------------------------------------------------------------------
  7.  
  8.   Q: What is voter++?
  9.   A: A full featuered voting door for your users to voice their opinions!
  10.  
  11.   Q: Is this thing hard to set up?
  12.   A: Only if you are dead!  Setup time is under 2 minutes, and that also
  13.      includes  the time it takes to grab a coke from the refrigerator and
  14.      to read these docs!
  15.  
  16.   Q: Do I have to pay to use this program?
  17.   A: You had to ask?  Yes, but that stuff is at the end of these docs.
  18.  
  19.   Q: Can we get on with the install?
  20.   A: OK...OK...Here it is in a nutshell.
  21.  
  22. ---------------------------------------------------------------------------
  23.  
  24.   1. create a directory somewhere on your hard drive, in example:
  25.         MD C:\PCB\PPE\VOTE
  26.  
  27.   2. Unzip your copy of voter++ into this directory you just created, IE:
  28.         PKUNZIP VOTER206.ZIP C:\PCB\PPE\VOTE
  29.  
  30.   3. Edit the VOTE.CFG file to reflect the info that needs to be changed,
  31.      a full description is after these instructions, as well as being in the
  32.      CFG file itself.
  33.  
  34.   4. Load up PCBSETUP and place Voter++ into your CMD.LST.  This is done by
  35.      typing PCBSETUP, then hit "B" for "File Locations", then hitting another
  36.      "B" for "Configuration Files", then using your cursor key to go down 8
  37.      selections until you get to "Name/Loc of Default CMD.LST File  :" Here you
  38.      either have a CMD.LST file, list if not, type in CMD.LST, then hit F2 to
  39.      get you into the CMD.LST editor, this will look like this:
  40.  
  41.                                   File Locations
  42.  
  43.        Command     Security  PPE/MNU File -or- Keystroke Replacement
  44.           ══════════════  ════════  ═══════════════════════════════════════
  45.           1) VOTE                0     C:\PCB\PPE\VOTE\VOTE.PPE
  46.  
  47.      Enter the required info so it looks like the above, and hit ESC to get out
  48.      of their, make sure you answer Y to save it.
  49.  
  50.   5. Now change to the Voter++ directory, and unzip the file called QUESTION.ZIP
  51.      once you do then you will have to edit the Sample QUE files for your
  52.      own questions and answers, (although these are some good questions and
  53.      should be good enough for your users to get the taste of voting!)Please
  54.      note that your Questions should remain under 71 characters in length,
  55.      while the answer lines should be under 65 characters each.
  56.  
  57.   6. If you want to let your users know the booths they haven't voted on yet,
  58.      just put a call (like !c:\pcb\ppe\vote\newbooth.ppe) into your security
  59.      specific files for the users you want to notify.  it will read in the
  60.      VOTE.CFG file and take it from there, no muss - no fuss!  Zero Maintenance.
  61.  
  62.   7. If you want a Full Color Bulletin for your users, you will need to go in
  63.      to pcbsetup and designate teh bulletin you want to give to Voter++, then
  64.      place the path and name of the bulletin into your VOTE.CFG line 7.
  65.      Can't get any easier than this!
  66.  
  67.   8. If you want to allow some users to create new booths, but to lock out
  68.      other users, you will want to edit the SECURITY.LST file to place the
  69.      security levels of the users you *DO NOT* want to create a booth.
  70.  
  71.   9. Go give it a try!
  72.  
  73. ------------------------------------------------------------------------------
  74.                      What are all those different files for?
  75.  
  76. Ok here is a listing of the files that came with Voter++, they are:
  77.  
  78. SYS_HELP.DSP - A help file for the sysop functions in the Secret Sysop Menu.
  79.     HELP.DSP - A help file for your users, short and sweet, but tells it all.
  80.     VOTE.CFG - Your Voter++ Config file, a full description after this.
  81.     VOTE.PPE - This is the program file, lovinglny crafted by Bill Marcy.
  82.     VOTE.PRM - Sysop modifiable prompts (see Prompt Section).
  83. NEWBOOTH.PPE - To let your users know what they haven't yet voted on.
  84. VOTEGRAF.PPE - Bulletin Generator that is called by Voter++. Setup and forget!
  85. SECURITY.LST - A security file for sec levels you do not want to creat a booth.
  86. QUESTION.ZIP - This is a zip with all of the sample question in it!
  87.    VOTE1.QUE \
  88.    VOTE2.QUE  \
  89.    VOTE3.QUE   - these (along with unlimited number) are your question files.
  90.    VOTE4.QUE  /
  91.    VOTE5.QUE /
  92.  
  93. In addition to these files, Voter++ will automatically build a few more files
  94. these are VOTE.ANS, which are the vote files, these are read by Voter++ to get
  95. the totals for the vote.  there is also a VOTE.NAM file, which is basically a
  96. log of who voted, when they voted, and how they voted, this is used by VOTER++
  97. to DIS-allow a user from voting on the same question twice, so, if you change
  98. a question manually, make sure you delete the corresponding VOTEX.NAM file!
  99.  
  100. The config file looks like this:
  101.  
  102. 16                           ;The total number of Questions you will have
  103. Joe Sysop                    ;Sysops full name
  104. Your BBS Name Here           ;BBS Name
  105. 0000001                      ;Registration Number
  106. YES                          ;Allow your users to create new booths
  107. 1                            ;Counter for the total number of users voting
  108. C:\PCB\GEN\BULL\BLT10        ;The bulletin you want created by VOTEGRAF
  109.  
  110.  
  111. Line by line, it goes like this:
  112.  
  113. Line 1 - this is the total number of voting booths you plan on having, there
  114.          is a no limit to booths, more can be added if you really need it, but
  115.          I couldn't come up with enough ideas for more than 16 sample booths,
  116.          so that was the number I used.  Make sure that you change this number
  117.          to reflect the total number of voting questions you plan on having.
  118.  
  119. Line 2 - This is the sysops Full Name, if you haven't gotten a registration
  120.          number from me, It really doesn't matter what you put in here, but
  121.          if you have gotten a reg number, make sure it is exactly the same as
  122.          the name you gave for the reg number, including case.
  123.  
  124. Line 3 - Your BBS name, this will be displayed once you have registered, if you
  125.          haven't registered, it is unimportant.
  126.  
  127. Line 4 - This is your unique registration number, you can see the end of these
  128.          docs on how to get this immediately.  It is easy and quick, and it
  129.          removes the (only slightly) annoying delay at the beggining of the
  130.          program load.
  131.  
  132. Line 5 - If you have YES in config line 5, Voter++ will present an additional
  133.          menu choice to your users (it will place it in the Secret Hidden Sysop
  134.          Menu choice for us sysops), which will allow them to create a new
  135.          booth.  I don't think any of us want them to be able to delete a
  136.          booth, or to edit an exisitng booth, but where is the harm in allowing
  137.          them to build a new one.  But, if you are against that Idea, just
  138.          place a NO in there and no option will be shown to them, they won't
  139.          even know what they are missing.
  140.  
  141. Line 6 - This is the counter that gets incremented everytime a voter enters
  142.          the Voter++ door, it is all automatic, so no need to worry about it.
  143.  
  144. Line 7 - This is the full path and name of the bulletin that you want VOTEGRAF
  145.          PPE to create.  Every time your voting users exit Voter++, the
  146.          Votegraf.PPE will regenerate the bulletin you specify, keeping your
  147.          users up-to-the-minute aware of what the popular consensus is!
  148.          This is a set up and forget feature, as you only have to give the
  149.          bulletin name and path once.  Enjoy!
  150.  
  151. -----------------------------------------------------------------------------
  152. VOTE.PRM and what is it for?
  153.  
  154. The VOTE.PRM file is a file of all sysop modifiable prompts, feel free to
  155. change tehm to reflect the language that your country speaks, but please
  156. make sure that the prompt is the same lenght (or shorter) as some of these
  157. prompts are shoe-horned in as it is.  In most cases you can go over the
  158. original prompt length by